home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / X11 / xtopo / README < prev    next >
Text File  |  1995-05-03  |  3KB  |  73 lines
  1.  
  2.  
  3. Written by Ronald Joe Record (rr@sco.com) 27 Oct 1992
  4.  
  5. INTRO
  6. -----
  7.  
  8. The idea here is to calculate and display a fractal landscape topographically.
  9. In order to accomplish this, a midpoint displacement algorithm is used.
  10. The colors in the image represent heights in the landscape. Landscapes of
  11. varying "roughness" or "smoothness" can be calculated by varying the 
  12. parameter "beta" which controls the fractal dimension.
  13.  
  14. ACKNOWLEDGEMENTS
  15. ----------------
  16.  
  17. The algorithm was derived from lectures given by Dietmar Saupe at the 
  18. University of California at Santa Cruz. Assistance with colormaps and 
  19. spinning color wheels and X was gleaned from Hiram Clawson and Stacey Campbell.
  20.  
  21. BUILD
  22. -----
  23.  
  24. To build the xtopo binary, either use the Imakefile or the sample makefile,
  25. Makefile.std.  If your system doesn't support prototypes, uncomment the 
  26. PROTODEFINE line of the Imakefile.
  27.  
  28. After modifying the Imakefile appropriately, either use "xmkmf" or "imake"
  29. to create a Makefile. Then just type "make" to compile xtopo.
  30.  
  31. The manual page can be formatted by typing "nroff -man xtopo.man > xtopo.6X".
  32.  
  33. INSTALL
  34. -------
  35.  
  36. To install xtopo, copy the xtopo binary to the desired location (the sample
  37. makefile puts it in /usr/local/bin)
  38. Copy the formatted man page to wherever you keep your local doc (i use
  39. /usr/man/cat.LOCAL for imaging software), then add that location
  40. to your MANPATH.
  41.  
  42. TEST
  43. ----
  44.  
  45. You can test xtopo by just invoking it with no arguments. It should display
  46. a 512x512 image. Some workstations may be slow to calculate and display a
  47. map as there are lots of calculations involved. On a DECstation 5000/200
  48. with 32 Mb memory, "time ./xtopo -V -d" gave a test timing of :
  49. real    0m17.46s
  50. user    0m5.30s
  51. sys     0m1.10s
  52.  
  53. On a Compaq 33 MHz 386 with no co-processor and 10 Mb memory, the same 
  54. command gave results of :
  55. real    4m18.09s
  56. user    4m7.32s
  57. sys     0m2.20s
  58.  
  59. Some "interesting" ways to run xtopo are as follows :
  60. % xtopo -F -S 0 -m 0 -r -n 10 -d
  61. (use the full screen, set sea level to 0, minimum upper color index to 0,
  62.  randomly select beta for each map, calculate 10 maps in demo mode)
  63. % xtopo -R -H 0.9
  64. (display on the root window a landscape with paramter beta equal to 0.9)
  65. % xtopo -o topomap.ppm
  66. (calculate and display with default parameters and save the resulting image
  67.  as a PPM file called topomap.ppm. this can be viewed later using xv or any
  68.  PPM viewing utility)
  69.  
  70. Ideas, comments, additions, deletions, suggestions, bug reports, code review,...
  71. e-mail Ronald Record at rr@sco.com or ...uunet!sco!rr.
  72.  
  73.